home *** CD-ROM | disk | FTP | other *** search
/ The Grafix CD 1 / The Grafix CD 1.iso / utils / _intergif / _help next >
Text File  |  1996-10-29  |  6KB  |  161 lines
  1.  
  2.                     InterGif 4
  3.                     ==========
  4.  
  5.         by Peter Hartley (K) All Rites Reversed
  6.     Desktop front-end adapted from one by Iain Logan
  7.  
  8. INTERGIF 4 is a program for making GIF images from 2-, 4-, 16- or
  9. 256-colour RiscOS sprite files, or from files produced with Iota
  10. Software's (commercial) animation program The Complete Animator. It
  11. can also convert from GIFs back to sprites.
  12.  
  13.  
  14.         Get the latest version
  15.         ----------------------
  16.  
  17. The latest version of InterGif, plus more help information and full
  18. source code, is always available on the World-Wide Web at the address
  19.         http://www.ant.co.uk/~peter/software/intergif.htm
  20. It's the twenty-seventh of October, 1996, as I'm writing these words
  21. (happy birthday, Anne): if it's long after that that you're reading
  22. them, you might want to see if there's a later version now available.
  23.  
  24.  
  25.         Distribution
  26.         ------------
  27.  
  28. InterGif is NOT COPYRIGHTED and is NOT distributed under the GNU
  29. General Public Licence. For full information read the file
  30. !InterGif.Copying or go to the Web site.
  31.  
  32.  
  33.         Features
  34.         --------
  35.  
  36.   o InterGif runs either on the desktop, or from the command line (so
  37.     I can produce the GIFs for my own Web pages, from the sprites
  38.     which constitute their source, using a make file!).
  39.  
  40.   o InterGif has options for the transparency and interleaving
  41.     features of GIF89a.
  42.  
  43.   o InterGif can take a sprite file (or an Animator file) containing
  44.     several frames, and produce from it an animated GIF which Netscape
  45.     2.0 or later, MSIE 3.0beta1 or later, or ANT Fresco 1.22 or later
  46.     will render as animated if it's inlined in a Web page.
  47.  
  48.   o InterGif will reduce its input to a smaller number of colours
  49.     (unless you explicitly tell it not to) if it can get away with it,
  50.     i.e. if only that many of the colours are used anyway.
  51.     
  52.   o It will also compress only the rectangle which has changed on each
  53.     frame, so if your animation has a complex but stationary
  54.     background, the background will only get compressed once.
  55.     Deviousness and cunning are employed to minimise the final size of
  56.     the GIF: so much so that many animated GIFs I've found on the Web
  57.     have ended up smaller when run through InterGif.
  58.  
  59.   o It can also make GIF images from Draw files if used in conjunction
  60.     with AADraw (see end).
  61.     
  62.  
  63.         Desktop use
  64.         -----------
  65.  
  66. Pretty straightforward. Run !InterGif; drag your sprite file, Animator
  67. file, or GIF onto the left-hand bit of the window; set any options you
  68. want in the middle bit of the window; and save your GIF or sprite file
  69. out from the right-hand bit of the window. The options are:
  70.  
  71.   o Interlaced
  72.         Produce an interlaced GIF: in other words, one which a Web
  73.     browser can render quickly at a low resolution, filling in the
  74.     details later as they arrive.
  75.  
  76.   o Looping animation
  77.         Normally an animated GIF plays through once and stops. If you
  78.     tick this option, you'll get an animated GIF that plays over and
  79.     over again. This is a Netscape extension to the GIF format, but
  80.     hopefully it will become a popular one -- both MSIE and Fresco now
  81.     support it too.
  82.  
  83.   o One frame per file
  84.         This splits up the input file into one output file per frame.
  85.     Not, I admit, terribly useful, unless you need to import something
  86.     into an application that expects lots of one-frame GIFs -- for
  87.     instance, Sun's Java Animator applet. The names of the files are
  88.     taken from the one you give, with any numeric part incremented as
  89.     needed, so if you save a three-frame animation as frame001/gif,
  90.     you also get frame002/gif and frame003/gif.
  91.  
  92.   o Keep source palette
  93.         This disables InterGif's palette optimisations and ensures
  94.     that the output has all the same colours, in the same order, as
  95.     the input.
  96.  
  97.   o Frame delay
  98.         This lets you set the frame rate, in centiseconds. The default
  99.     is 8 centiseconds per frame (12.5 frames per second).
  100.  
  101.   o Transparency
  102.         Choose None to get a wholly opaque GIF (no masking), Auto to
  103.     get InterGif to use the sprites' masks (or the film's background
  104.     colour); or you can specify a transparent pixel-value directly.
  105.     (Hint: to find out what pixel-value a sprite pixel has, load the
  106.     sprite into Paint, ensure its palette window is showing, click
  107.     Menu over the pixel you want, and choose "Paint->Select colour".
  108.     
  109.  
  110.         Command-line use
  111.         ----------------
  112.         
  113. For this, you'll probably want to copy !InterGif.intergif into your
  114. library directory.
  115.     At its simplest, you can just type intergif and the name of your
  116. sprite or film file, and it'll be converted. Here's a full list of the
  117. options:
  118.  
  119. intergif [-i] [-loop] [-s ] [-split] [-same] [-d cs] [-t [pixel]]
  120.          [-o outfile] infile
  121.  
  122.     -i
  123.         Produce an interlaced GIF
  124.     -loop
  125.         Looping animation
  126.     -s
  127.         Produce a sprite rather than a GIF
  128.     -split
  129.         One frame per file
  130.     -same
  131.         Keep source palette
  132.     -d cs
  133.         Frame delay in centiseconds
  134.     -t
  135.         Use automatic transparency (default is no transparency)
  136.     -t pixel
  137.         Use specified pixel as transparent
  138.     -o outfile
  139.         Filename for the output (default is <infile>/gif)
  140.     infile
  141.         A RiscOS sprite, Complete Animator or GIF file
  142.  
  143.  
  144.         See also
  145.         --------
  146.  
  147.     The InterGif page
  148.         http://www.ant.co.uk/~peter/software/intergif.htm
  149.     The AADraw page
  150.         http://www.ant.co.uk/~peter/software/aadraw.htm
  151.     The Complete Animator
  152.         http://www.iota.co.uk/animator/
  153.     GIF89a specification
  154.         http://asterix.seas.upenn.edu/~mayer/lzw_gif/gif89a.html
  155.     Animated GIFs for other platforms
  156.         http://www.n-vision.com/panda/gifanim/
  157.  
  158.  
  159.                                                         peter@ant.co.uk
  160.                                                         27th October 96
  161.